package com.zzx.service;

import com.zzx.bean.Express;
import com.zzx.exception.DuplicateCodeException;

import java.util.List;
import java.util.Map;

/**
 * @Author: Spider Man
 * @Description: 用于定义express表格的操作规范
 * @Date Created in 2020-09-12 14:54
 * @Modified By:
 */
public interface BaseExpressService {

    /**
     * 用于查询数据库中的全部快递（总数+新增），代取件快递（总数+新增）
     * @return [{size:总数,day:新增},{size:总数,day:新增}]
     */
    List<Map<String,Integer>> console();

    /**
     * 用于查询所有快递的信息
     * @param limit 是否分页的标记，true表示要分页，false表示不用分页
     * @param offset SQL语句的起始索引
     * @param pageNumber 页查询的数量
     * @return 快递对象的集合
     */
    List<Express> findAllExpressInfo(boolean limit,int offset,int pageNumber);


    /**
     * 根据快递单号查询快递信息
     * @param number 快递单号
     * @return 查询的快递信息，单号不存在时返回null
     */
    Express findExpressByNumber(String number);

    /**
     * 根据取件码查询快递信息
     * @param code 取件码
     * @return 查询的快递信息，取件码不存在时返回null
     */
    Express findExpressByCode(String code);

    /**
     * 根据用户手机号码查询快递信息
     * @param userPhone 用户手机号码
     * @return 查询的快递信息，用户手机号码不存在时返回null
     */
    List<Express> findExpressByUserPhone(String userPhone);

    /**
     * 根据用户手机号码和快递的状态码查询快递信息
     * @param userPhone 用户手机号码
     * @return 查询的快递信息，用户手机号码不存在时返回null
     */
    List<Express> findExpressByUserPhoneAndStatus(String userPhone,int status);

    /**
     * 根据录入人手机号码查询快递信息
     * @param sysPhone 录入人手机号码
     * @return 查询的快递信息，录入人手机号码不存在时返回null
     */
    List<Express> findExpressBySysPhone(String sysPhone);

    /**
     * 快递的录入
     * @param express 快递对象
     * @return ture表示录入成功，false表示失败
     */
    boolean insert(Express express);

    /**
     * 快递的修改
     * @param id 快递的ID
     * @param express 新的快递对象
     * @return ture表示更新成功，false表示更新失败
     */
    boolean update(int id,Express express);

    /**
     * 更加ID删除快递信息
     * @param id 要删除的快递ID
     * @return true表示成功，false表示删除失败
     */
    boolean delete(int id);

    /**
     * 更改快递的状态
     * @param code 快递单号
     * @return true表示成功，false表示失败
     */
    boolean updateStatus(String code);
}